home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / sphbitmap.z / sphbitmap
Encoding:
Text File  |  1998-10-20  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp((((3333GGGG))))                                              sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp,,,, sssspppphhhheeeennnnddddbbbbiiiittttmmmmaaaapppp - delimit specification of bitmapped spheres
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ggggllll////sssspppphhhheeeerrrreeee....hhhh>>>>
  13.  
  14.      vvvvooooiiiidddd sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp((((vvvvooooiiiidddd))))
  15.  
  16.      vvvvooooiiiidddd sssspppphhhheeeennnnddddbbbbiiiittttmmmmaaaapppp((((vvvvooooiiiidddd))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _n_o_n_e
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      Spheres specified with sssspppphhhhddddrrrraaaawwww after sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp and before sssspppphhhheeeennnnddddbbbbiiiittttmmmmaaaapppp
  23.      are drawn with bitmapped spheres.  The bitmap contains an image of a
  24.      phong-shaded sphere.  The diffuse color of the sphere may be specified by
  25.      sssspppphhhhccccoooolllloooorrrr.
  26.  
  27.      Between sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp and sssspppphhhheeeennnnddddbbbbiiiittttmmmmaaaapppp, only calls to sssspppphhhhccccoooolllloooorrrr and sssspppphhhhddddrrrraaaawwww
  28.      are permitted and including any GL calls or other Sphere Library calls
  29.      will produce undefined results.
  30.  
  31. NNNNOOOOTTTTEEEE
  32.      Bitmapped spheres are currently only implemented on the RealityEngine,
  33.      and with several restrictions.
  34.  
  35.      The framebuffer must be configured for RGBmode with the standard buffer,
  36.      ie.  the zbuffer must not be deallocated with zzzzbbbbssssiiiizzzzeeee.... Multisample buffers
  37.      must not be allocated. The projection matrix for bitmapped spheres must
  38.      be orthographic and use of perspective, such as calls to ppppeeeerrrrssssppppeeeeccccttttiiiivvvveeee or
  39.      wwwwiiiinnnnddddoooowwww will produce undefined results.
  40.  
  41.      The following operations are not obeyed when drawing bitmap spheres:
  42.      accumulation buffering, blending, feedback, fog, lighting, logicop,
  43.      picking, stencil, texturing, and writemask.
  44.  
  45.      The values for blendfunction and logicop are reset to their default
  46.      values.  If writemasking was being used previous to drawing bitmapped
  47.      spheres, the resulting writemask after sssspppphhhheeeennnnddddbbbbiiiittttmmmmaaaapppp, will be undefined.
  48.      Therefore, it is best too ensure that blendfuction, logicop, and
  49.      writemask modes are not being used when entering the bitmap sphere mode
  50.      to avoid surprises.
  51.  
  52.      On RealityEngine, bitmapped spheres compete for framebuffer memory with
  53.      stereobuffer and at least a medium pixel depth is required to have room
  54.      for both.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp((((3333GGGG))))                                              sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74. BUGS
  75.      Bitmapped spheres on RealityEngine are currently only available in
  76.      immediate mode.
  77.  
  78.      Bitmapped spheres do not clip correctly but pop when clipped against the
  79.      near and far clipping planes. User-defined clipping planes are ignored by
  80.      the bitmapped spheres.
  81.  
  82.      Currently, on RealityEngine, sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp is relatively slow to execute
  83.      and so it is best to minimize the number of times the bitmap sphere mode
  84.      is entered in a frame.  Draw as many spheres as possible between one set
  85.      of sssspppphhhhbbbbggggnnnnbbbbiiiittttmmmmaaaapppp and sssspppphhhheeeennnnddddbbbbiiiittttmmmmaaaapppp calls.
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      libsphere, sphdraw, sphcolor, acbuf, blendfunction, feedback, fogvertex,
  89.      logicop, lmdef, mssize, pick, RGBmode, stencil, texdef, writemask, zbsize
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.